package com.dji.sample.wayline.service;

import com.dji.sample.wayline.model.entity.Flyer;
import com.dji.sdk.common.HttpResultResponse;
import com.dji.sdk.common.PaginationData;

import java.util.List;
import java.util.Optional;

/**
 * 飞手服务接口
 * 定义了对飞手信息进行增删改查操作的方法
 *
 * @author sean
 * @version 1.0
 * @date 2024/1/1
 */
public interface IFlyerService {

    /**
     * 创建飞手信息
     * @param flyer 飞手信息
     * @return 创建结果
     */
    HttpResultResponse<Flyer> createFlyer(Flyer flyer);

    /**
     * 根据ID删除飞手信息
     * @param id 飞手ID
     * @return 删除结果
     */
    HttpResultResponse<Boolean> deleteFlyerById(Long id);

    /**
     * 批量删除飞手信息
     * @param ids 飞手ID列表
     * @return 删除结果
     */
    HttpResultResponse<String> deleteFlyers(List<Long> ids);

    /**
     * 更新飞手信息
     * @param flyer 飞手信息
     * @return 更新结果
     */
    HttpResultResponse<Boolean> updateFlyer(Flyer flyer);

    /**
     * 根据ID查询飞手信息
     * @param id 飞手ID
     * @return 飞手信息
     */
    Optional<Flyer> getFlyerById(Long id);

    /**
     * 根据飞手姓名查询飞手信息
     * @param flyerName 飞手姓名
     * @return 飞手信息
     */
    Optional<Flyer> getFlyerByName(String flyerName);

    /**
     * 根据手机号查询飞手信息
     * @param phone 手机号
     * @return 飞手信息
     */
    Optional<Flyer> getFlyerByPhone(String phone);

    /**
     * 分页查询飞手信息
     * @param page 页码
     * @param pageSize 每页大小
     * @param status 飞手状态（可选）
     * @param level 飞手等级（可选）
     * @return 分页结果
     */
    PaginationData<Flyer> getFlyers(long page, long pageSize, Integer status, Integer level);

    /**
     * 查询所有飞手信息
     * @return 飞手列表
     */
    List<Flyer> getAllFlyers();

    /**
     * 根据状态查询飞手信息
     * @param status 飞手状态
     * @return 飞手列表
     */
    List<Flyer> getFlyersByStatus(Integer status);

    /**
     * 根据等级查询飞手信息
     * @param level 飞手等级
     * @return 飞手列表
     */
    List<Flyer> getFlyersByLevel(Integer level);
}